revSetCardProfile
Type
command
Summary
Changes the current profile used for a card and all its objects.
Syntax
revSetCardProfile <profileName> [, <stackName>]
Description
Use the revSetCardProfile command to change property settings on a card to a different set of stored settings.
Although the revSetCardProfile command changes a card, you specify a stack name, not a card name.
A profile is a set of property settings for an object. You create a profile for an object, and give it a name, using the Property Profiles pane in the object's property inspector. When you change that object to use a profile, the properties you specified in the profile are changed to the settings you specified. This helps you quickly switch the appearance and behavior of the object without needing to set its properties individually.
The revSetCardProfile command changes the profile of the current card of the specified stack and all the objects on that card. If an object does not have a profile with the specified profileName, the object's properties are not changed.
The revSetCardProfile command is part of the Profile library. To ensure that the command works in a standalone application, in the Profiles section on the General screen of the Standalone Application Settings window, make sure you choose to include profiles in your application.
Parameters
| Name | Type | Description |
|---|---|---|
profileName | The profileName specifies which profile to use. | |
stackName | The short name of an open stack. If you don't specify a stack, the current card of the topStack is changed. |
Examples
revSetCardProfile "MetallicLook"
revSetCardProfile "Master",the mainStack of this stack
Related
keyword: card
library: Profile library
object: stack
property: properties
command: revSetStackFileProfile
glossary: object, property, current card, Standalone Application Settings, property profile, command, standalone application
Compatibility and Support
Introduced
LiveCode 2.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile